-- 1 means the first PICT in the sequence is shown when the
-- dialog is first displayed
-- FALSE means that you can't cycle round and round thru the PICTs
-- (In other words, when you get to the last PICT, the "NEXT" button
-- grays out; and when you get to the first PICT, the "PREV" button
-- grays out.) If this parameter was TRUE, you would be able to
-- cycle continuously thru the PICTs
-- the PICTs must be numbered sequentially
-- (in this case the 5 PICTs are 1003, 1004, 1005, 1006, and 1007)
-- part 3 (button)
-- low flags: 00
-- high flags: 0000
-- rect: left=11 top=4 right=64 bottom=78
-- title width / last selected line: 0
-- icon id / first selected line: 529 / 529
-- text alignment: 1
-- font id: 0
-- text size: 12
-- style flags: 0
-- line height: 16
-- part name: SD
-- part contents for background part 21
----- text -----
ShowDialog XCMD Type 6
-- part contents for background part 30
----- text -----
18
-- part contents for background part 15
----- text -----
ShowDialog Type 6 parameters are:
ShowDialog 6,<DLOG resource ID>,<resource ID of first PICT>,<total number of PICTs to show>,
<PICT to display>,<cycle screens BOOLEAN>,
[<top coord>,<left coord>]
where 6 is the type of the external;
<DLOG resource ID> is the DLOG resource ID;
<resource ID of first PICT> is the ID number of the first PICT in the PICT "sequence";
<total number of PICTs to show> is the total number of PICTs that will be cycled through;
<PICT to display> is the ordinal number of the PICT
(from the sequence) that will be shown when the dialog is first displayed (1 will show the first PICT in the sequence, 5 will show the fifth);
<cycle screens BOOLEAN> describes whether the screens can be cycled. If this parameter is FALSE, the PREV and NEXT buttons will gray out on the first and last PICTs respectively. If TRUE, the buttons NEVER gray out and the screens can be cycled through continuously.
Once again, the last two parameters, for specifying the location of the dialog, are OPTIONAL.
If you click DITL item#1, the result will contain FALSE. If you have an ENABLED DITL item#7, and click on it, the result will contain TRUE. See the script of the "ListDialog 2" on the card "ShowDialog XCMD Type 7" for an example.
• Click here to see it now. •
The first PICT ID can be ANY number. The subsequent PICTs MUST be sequentially numbered. So if you specify your first PICT as 2001, the others MUST be 2002, 2003, 2004, etc.
-- part contents for background part 17
----- text -----
Follow this outline when constructing the DITL resource:
DITL item# 1: an ENABLED button. This will be the Cancel button.
DITL item# 2: a DISABLED useritem. This item will be the area into which the PICTs will be drawn and, consequently, should be made large.
DITL item# 3: your "Previous" button. Clicking this will cycle the PICTs backward.
DITL item# 4: your "Next" button. Clicking this will cycle the PICTs forward.
DITL item# 5: DISABLED static text. This will contain a descriptive header for each PICT.
DITL item# 6: DISABLED static text. This will contain a running tally of the PICTs. It will contain the phrase "Page x of y," where x is the ordinal number of the PICT currently displayed, and y is the total number of PICTs. DITL items 5 and 6 are OPTIONAL; you can omit them if you want.
If a required PICT resource is missing, the dialog will beep and appear with a blank display.
Notice how the "header" and "tally" fields change as you cycle through the PICTs in Type 6.
Your PICTs will be displayed within DITL item# 2
(the useritem) of the template. They will be centered if they are smaller then the display field and will be SCALED DOWN to fit into the field if they are too large. Keep in mind that if your PICTs are too large for the display rectangle that they will be squashed down to fit. (This is unsightly.)
PICTs are costly, in terms of disk space. A PICT with a large bitmap graphic can make your stack very large. This is ESPECIALLY true for color PICTs. A tip for economizing on your PICTs is to create them in a unified graphics application, such as SuperPaint. Make the graphic in the paint layer and then switch to the draw layer for the text. When you copy the image to the Clipboard (for later pasting into the stack with ResEdit) the text will be saved as ASCII, NOT as a bitmap. The resulting PICT will be smaller than if you had done the text in the paint layer.
After you have created your PICT and inserted it into the stack with ResEdit, be sure to name the resource with something descriptive. It is the PICT's name that will appear in the "header" field (DITL item# 5) in Type 6 of ShowDialog.
If you've been using versions of ShowDialog older than 1.5 please note that the parameters for Type 6 have changed to make it function more closely to Type 5.
ShowDialog XCMD Type 6 displays PICTs within the dialog in a fashion similar to Type 5. The difference is that this dialog contains a "Previous" and a "Next" button for cycling through the total number of PICTs.
This dialog can also optionally contain a descriptive
"header" for each PICT, and a running tally of which one of the total number of PICTs is being displayed.
Here, too, clicking on the Cancel button, or hitting enter or return dismisses the dialog.
